home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2005 October / PCWOCT05.iso / Software / FromTheMag / XAMPP 1.4.14 / xampp-win32-1.4.14-installer.exe / xampp / webalizer / INSTALL < prev    next >
Text File  |  2002-04-23  |  10KB  |  240 lines
  1. Installation instructions for The Webalizer
  2.  
  3. The Webalizer is distributed in either source or binary distributions,
  4. and installation is different for each type.  Regardless of the type
  5. of installation, you need to obtain and un-tar/un-zip the distribution
  6. file somewhere.  For binary distributions, you should create a directory
  7. somewhere and chdir to it before unpacking the file.  Source distributions
  8. will automagically create a directory for you (webalizer-x.xx-xx).  If
  9. you are upgrading from a previous version, check the CHANGES file, and
  10. the README.FIRST file for important upgrade information.
  11.  
  12.  
  13. For Binary distributions
  14. ------------------------
  15.  
  16. You should have all the files you need in the directory you created
  17. when you un-tarred/un-zipped the distribution file.  The file
  18. 'webalizer' in this directory is the binary executable.  Copy this
  19. someplace useful, like /usr/local/bin or /usr/bin.  A man page for
  20. The Webalizer is also supplied... If desired, copy the file
  21. 'webalizer.1' to your local man directory (ie: /usr/local/man/man1).
  22. (You may also need to run 'makeinfo' or similar)
  23.  
  24. Note: There may also be platform specific installation instructions
  25.       and/or usage notes supplied with the binary distribution.  You
  26.       should read them, as that will be your starting point if problems
  27.       are encountered.  Most of the binary distributions are submitted
  28.       by users, and I cannot support them the same way I can the
  29.       Linux binary distribution and the source code itself.
  30.  
  31.  
  32. For Source distributions
  33. ------------------------
  34.  
  35. The Webalizer requires the GD graphics library by Tom Boutell.  If
  36. you don't already have it, go to http://www.boutell.com/gd/ and
  37. grab a copy.
  38.  
  39.  
  40. New style build:
  41.  
  42. The Webalizer source distribution now comes packaged with a GNU
  43. autoconf 'configure' script, which should allow you to simply type:
  44.  
  45. ./configure
  46. make
  47. make install
  48.  
  49. Normal configure options apply, type ./configure --help to get a
  50. complete list.  A few options in particular may be useful:
  51.  
  52. --with-language=<language>
  53.  
  54. Allows you to specify the language to use.  Check the /lang directory
  55. to see the available language choices.  As an example, you could use
  56.  
  57. ./configure --with-language=french
  58.  
  59. to compile the program using french (webalizer_lang.french) for output.
  60. You can also use the --without-language switch, which will use the
  61. default language (english).
  62.  
  63. --with-gdlib=<path-to-gd-library>
  64. --with-gd=<path-to-gd-headers>
  65.  
  66. The configure script will attempt to locate the gd library and header
  67. files in some of the more usual places, and should find them in most
  68. cases.  If you have the files someplace unusual, you can specify
  69. additional locations to look for them with this option.  (If you are
  70. compiling gd in your home directory, and don't want to or can't put
  71. them in the normal system places, create a directory under the webalizer
  72. named 'gd' or 'gd1.3' for it and the script should find it without
  73. problems or extra command line switches).
  74.  
  75. --enable-dns
  76.  
  77. DNS lookup features are added.  This simply adds the -DUSE_DNS compiler
  78. switch.  Several dependencies are present when using the DNS code,
  79. which is why it must be enabled manually.  If you system supports the
  80. DNS functionality, great.. if not, don't enable it.
  81.  
  82. Some systems may require unusual settings that the configure script
  83. cannot determine.  You can pass values to the script by setting
  84. environment variables.  For example:
  85.  
  86. CC=c89 CFLAGS=-O LIBS=-lposix ./configure --with-language=german
  87.  
  88. Would allow you to set the compiler (c89) and various flags and
  89. libraries to use, which would then be passed to the configure script
  90. and eventually to the Makefile generated.  It also will cause the
  91. program to be compiled using German instead of the English default.
  92.  
  93. If the configure script doesn't work for you.. please let me know
  94. (along with relevant info like system type, compiler, etc..)  If you
  95. are able and can tweek something to make it work, let me know as well.
  96.  
  97.  
  98. Old style build:
  99.  
  100. If you have a platform that the configure script won't work on, or
  101. some other situation where you have to configure and build the
  102. source yourself,  the file 'Makefile.std' is a "stock" Makefile
  103. that you can use to build the Webalizer.  Copy or rename the file
  104. to 'Makefile', edit to match your system, and do the usual 'make'.
  105. If everything seems to have gone well, next type 'make install'.
  106.  
  107. This will install the Webalizer on your system, and put a sample
  108. configuration file in /etc (named 'webalizer.conf.sample').  If
  109. you don't want to use the 'make install' method... just copy the
  110. file 'webalizer' to someplace usefull and you are ready to go :)
  111.  
  112. Makefile.std works on a stock slackware 3.6 linux system. YMMV.
  113.  
  114.  
  115. Usage
  116. -----
  117.  
  118. When run, The Webalizer will read the specified log file and
  119. produce HTML output in the directory specified (or current
  120. directory if none).  You may specify various configuration
  121. options either on the command line or in a configuration file.
  122. The format of the command line is:
  123.  
  124. webalizer [options] [log_file]
  125.  
  126. Where 'options' may be any of the valid command line options
  127. described in the README file.  If a log filename is not given,
  128. input is taken from stdin.  A typical command line might look
  129. something similar to:
  130.  
  131. webalizer /var/lib/httpd/logs/access_log
  132.  
  133. This will produce output in the current directory based on the
  134. logfile /var/lib/httpd/logs/access_log.  Another example:
  135.  
  136. webalizer -c somehost.conf
  137.  
  138. This will read the configuration file somehost.conf, which
  139. should specify, among other things, the log filename and
  140. output directory to use.  You can use 'webalizer -h' to get
  141. a list of available command line options, or view the file
  142. README for complete instructions on all available configuration
  143. options.  You should note that The Webalizer will _always_
  144. look for a configuration file named 'webalizer.conf' in either
  145. the current directory or in /etc/, and will process that file
  146. _before_ any other configuration or command line options.  If
  147. you run a single server, you may want to create a default
  148. configuration file and place it in the /etc/ directory.  This
  149. will allow you to simply type 'webalizer' without the need to
  150. specify additional command line options.
  151.  
  152.  
  153. Configuration
  154. -------------
  155.  
  156. The Webalizer can be customized in many ways using either the
  157. command line or configuration files.  To test The Webalizer,
  158. type: 'webalizer /var/lib/httpd/logs/access_log', changing the
  159. directory to wherever your log files are.  After processing,
  160. you should have the output and a file named index.html which
  161. can be viewed with any browser.  The Webalizer can accept many
  162. command line options as well, type 'webalizer -h' to view them.
  163. In addition to the command line options, The Webalizer can
  164. be customized using configuration files. There is a sample.conf
  165. file that is part of both the source and binary distributions
  166. that can be used as a 'template' for creating your own site
  167. configuration file.  Just make a copy of the file and name it
  168. something like 'mysite.conf'.  Edit the new file to match your
  169. particular setup and taste.
  170.  
  171. To test the new configuration file, type 'webalizer -c mysite.conf'
  172. (or whatever your configuration file is named).  Fire up the
  173. browser and look at the results.  If you rename your new
  174. configuration file to 'webalizer.conf', you will only need
  175. to type 'webalizer', and The Webalizer will use it as the
  176. default.  See the README file for more on configuation and
  177. use of configuation files.
  178.  
  179.  
  180. Language Support
  181. ----------------
  182.  
  183. Language support is provided as language specific header
  184. files that must be compiled into the program.  If you don't
  185. have the source code, get it.  If you can't compile the
  186. program yourself, ask a friend.  The /lang/ directory of
  187. the distribution contains all supported languages at the
  188. time of release.  Additional/updated language files will
  189. be found at ftp://ftp.mrunix.net/pub/webalizer/lang and
  190. are always the most current versions.
  191.  
  192. To build with language support, use the --with-language
  193. option of the configure script.  This will automagically
  194. do for you the steps described below.  If you can't use
  195. the configure script, you can manually select the language
  196. file to use.
  197.  
  198. In the webalizer source directory, you will find a symbolic
  199. link for the file webalizer_lang.h, and it will be pointing
  200. to the file webalizer_lang.english which is the default.
  201. Delete the link (ie: rm webalizer_lang.h) and create a new
  202. one to the language file you want The Webalizer to use
  203. (ie: ln -s lang/webalizer_lang.spanish webalizer_lang.h)
  204. and re-compile the program.
  205.  
  206. Note: The source distribution of The Webalizer contains all
  207.       language support files that were available at the time.
  208.       Additional/updated language files can be found at:
  209.       ftp://ftp.mrunix.net/pub/webalizer/lang where I will put
  210.       them as I receive them.
  211.  
  212.  
  213. Common Questions
  214. ----------------
  215.  
  216. Q: Will it run on [some platform]
  217. A: If it is a *nix platform, it should without a problem.  If it's
  218.    something different, probably not and your on your own if you
  219.    want to try to make it work.
  220.  
  221. Q: When I compile, I get "file not found" errors?
  222. A: Most likely, the compiler cant find the header files for the
  223.    GD Graphics library.  If they are someplace other than the
  224.    default /usr/local/include/gd, then you need to change the
  225.    GDLIB variable in the Makefile to point to the proper place.
  226.  
  227. Q: I get "libgd not found' errors?
  228. A: You don't have the GD graphics located in a standard library
  229.    path, or you don't have the GD graphics library at all.  If
  230.    the later, go to http://www.boutell.com/gd/ and grab a copy.
  231.    If you do have it, add a -L switch in the Makefile to point
  232.    to the proper location.
  233.  
  234. Q: I can't get the GD graphics library to compile?
  235. A: The GD Library was written (and hopefully maintained) by
  236.    Tom Boutell, not me.  Visit his web site, ask him a
  237.    question or hit one of the newsgroups...  I can't help you
  238.    out too much with this one.
  239.  
  240.